pdf-icon

Arduino Quick Start

2. Devices & Examples

Tough Touch Screen

Tough touch screen related APIs and example programs.

Example Program

Build Requirements

  • M5Stack Board Manager version >= 2.1.4
  • Board selection = M5Tough
  • M5Unified library version >= 0.2.5
  • M5GFX library version >= 0.2.7
cpp
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37
#include <M5Unified.h>
#include <M5GFX.h>

m5::touch_detail_t touchDetail;

int width, height;

void setup() {
  M5.begin();
  M5.Display.setRotation(1);
  M5.Display.setFont(&fonts::DejaVu40);

  width = M5.Display.width();
  height = M5.Display.height();

  Serial.begin(115200);
  Serial.println("Start touching!");
  M5.Display.print("Start touching!");
}

void loop() {
  M5.update();
  touchDetail = M5.Touch.getDetail();

  if (touchDetail.isPressed()) {
    Serial.printf("x:%d, y:%d\r\n", touchDetail.x, touchDetail.y);

    for (int i = 0; i < width; i += 10) {
      for (int j = 0; j < height; j += 10) {
        uint8_t cr = map((touchDetail.x - i) % width, 0, width, 0, 256);
        uint8_t cg = map((touchDetail.y - j) % height, 0, height, 0, 256);
        uint16_t color = M5.Display.color565(cr, cg, 255 - (cr + cg) / 2);
        M5.Display.fillRect(i, j, 10, 10, color);
      }
    }
  }
}

The main function of this program is to output the coordinates of the touch point to the computer via serial when the screen is touched by a finger. A colorful array on the screen follows the touch point as it moves. The program only reads a single touch point, but you can develop two-point touch functionality on Tough using the API introduced below.

API

The Tough touch screen functionality uses the Touch_Class from the M5Unified library. For more related APIs, please refer to the following documentation:

On This Page