Arduino Quick Start
2. Devices & Examples
3. M5Unified
4. M5GFX
5. Extensions
Unit
Base
Cap
StamPLC
IoT
Accessories
Tab5 Touch
Tab5 Touch related APIs and example.
Example
Compilation Requirements
- M5Stack board manager version >= 3.2.0
- Board selection = M5Tab5
- M5Unified library version >= 0.2.7
- M5GFX library version >= 0.2.8
1.Touch Button Detection
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; static int32_t w; static int32_t h; LGFX_Button button; void setup() { M5.begin(); w = M5.Lcd.width(); h = M5.Lcd.height(); M5.Lcd.fillScreen(WHITE); M5.Display.setRotation(0); M5.Display.setTextDatum(top_center); M5.Display.drawString("Button Released", w / 2, 0, &fonts::FreeMonoBold24pt7b); button.initButton(&M5.Lcd, w / 2, h / 2, 200, 200, TFT_BLUE, TFT_YELLOW, TFT_BLACK, "BTN", 4, 4); button.drawButton(); } void loop() { M5.update(); touchDetail = M5.Touch.getDetail(); if (touchDetail.isPressed()) { if(button.contains(touchDetail.x, touchDetail.y)){ M5.Display.drawString("Button Pressed", w / 2, 0, &fonts::FreeMonoBold24pt7b); } } else { M5.Display.drawString("Button Released", w / 2, 0, &fonts::FreeMonoBold24pt7b); } }The program's function is: when a finger touches the screen, if the touch point is within the button area, it displays "Button Pressed"; otherwise, it displays "Button Released".
2.Multi-touch Detection
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 38 39 40 41 42
#include <M5Unified.h> #include <M5GFX.h> m5::touch_point_t touchPoint[5];//Tab5 supports up to 5-point touch static bool drawed = false; static int32_t w; static int32_t h; void setup() { M5.begin(); w = M5.Lcd.width(); h = M5.Lcd.height(); M5.Lcd.fillScreen(WHITE); M5.Display.setRotation(0); M5.Display.setTextDatum(top_center); M5.Display.drawString("Touch not found", w / 2, 0, &fonts::FreeMonoBold24pt7b); M5.Display.setFont(&fonts::FreeMonoBold24pt7b); } void loop() { M5.update(); int nums = M5.Lcd.getTouchRaw(touchPoint, 5); if (nums) { M5.Display.drawString(" Touch detail: ", w / 2, 0, &fonts::FreeMonoBold24pt7b); for (int i = 0; i < nums; i++) { M5.Display.setCursor(50, 160 + i * 48); M5.Display.printf("Point %d X:%04d Y:%04d", i+1, touchPoint[i].x, touchPoint[i].y); } drawed = true; } else if (drawed){ drawed = false; M5.Display.clear(WHITE); M5.Display.drawString("Touch not found", w / 2, 0, &fonts::FreeMonoBold24pt7b); } vTaskDelay(1); }The program's function is: when a finger touches the screen, it displays the coordinates of the touch point. Tab5 supports up to 5-point touch.
API
The Touch of the Tab5 uses the Touch_Class from the M5Unified library. For more related APIs, refer to the documentation below: