m5-docs/docs/en/api/m5paper/touch.md

TOUCH-GT911

This is the M5Stack Paper touchscreen library.

GT911

In the M5.begin() initialization, the instance GT911 TP = GT911(); has been created and initialized. You can use the API in this instance to get the touch interaction information.

• Functions: Initialize I2C bus.

• esp_err_t begin(uint8_t pin_sda, uint8_t pin_scl, uint8_t pin_int);

• Functions: if there is new screen touch data to be read.

• bool avaliable();

• Functions: screen refresh detection

• void update();

• Functions: Set screen rotation angle/usually set to 90°.

• void SetRotation(uint16_t rotate);

• Function: Read the X-coordinate of the touch finger.

• uint16_t readFingerX(uint8_t num);

• Function: read touch finger Y coordinate

• uint16_t readFingerY(uint8_t num);

• Function: Read the touch finger ID coordinates.

• uint16_t readFingerID(uint8_t num);

• Function: read the size of the rectangle in the area where the touch finger acts.

• uint16_t readFingerSize(uint8_t num);

• Functions: last read number of fingers touched

• uint8_t getFingerNum(void);

• Function: detect if the finger is raised.

• bool isFingerUp(void);

• Function: Clear the current touch state

• void flush(void);

• Function: Read touch finger information, return to structure instance

• tp_finger_t readFinger(uint8_t num);

typedef struct
{
    uint16_t x;
    uint16_t y;
    uint16_t id;
    uint16_t size;
}tp_finger_t;

Example：

#include <M5EPD.h>

M5EPD_Canvas canvas(&M5.EPD);

int point[2][2];

void setup()
{
    M5.begin();
    M5.EPD.SetRotation(90);
    M5.TP.SetRotation(90);
    M5.EPD.Clear(true);
    canvas.createCanvas(540, 960);
    canvas.setTextSize(5);
    canvas.drawString("Touch The Screen!", 20, 400);
    canvas.pushCanvas(0,0,UPDATE_MODE_DU4);
}

void loop()
{

    if(M5.TP.avaliable()){
        if(!M5.TP.isFingerUp()){
            M5.TP.update();
            canvas.fillCanvas(0);
            bool is_upadte = false;
            for(int i=0;i<2; i++){
                tp_finger_t FingerItem = M5.TP.readFinger(i);
                if((point[i][0]!=FingerItem.x)||(point[i][1]!=FingerItem.y)){
                    is_upadte = true;
                    point[i][0] = FingerItem.x;
                    point[i][1] = FingerItem.y;
                    canvas.fillRect(FingerItem.x-50, FingerItem.y-50, 100, 100, 15);
                    Serial.printf("Finger ID:%d-->X: %d*C  Y: %d  Size: %d\r\n", FingerItem.id, FingerItem.x, FingerItem.y , FingerItem.size);
                }
            }
            if(is_upadte)
            {
                canvas.pushCanvas(0,0,UPDATE_MODE_DU4);
            }
        }
    }
}