pdf-icon

Arduino 上手教程

Paper Touch-GT911 触摸屏

M5.begin()初始化中,已经创建了实例GT911 TP = GT911()并进行了初始化. 你可以用该实例中的API获取触摸交互信息。

begin()

功能说明:

初始化I2C总线

函数原型:

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

avaliable()

功能说明:

是否有新的屏幕触摸数据待读取

函数原型:

bool avaliable();

update()

功能说明:

刷新屏幕检测

函数原型:

void update();

SetRotation()

功能说明:

设置屏幕旋转角度/通常设置为90°

函数原型:

void SetRotation(uint16_t rotate);

readFingerX()

功能说明:

读取触摸手指X坐标

函数原型:

uint16_t readFingerX(uint8_t num);

readFingerY()

功能说明:

读取触摸手指Y坐标

函数原型:

uint16_t readFingerY(uint8_t num);

readFingerID()

功能说明:

读取触摸手指ID坐标

函数原型:

uint16_t readFingerID(uint8_t num);

readFingerSize()

功能说明:

读取触摸手指作用区域矩形大小

函数原型:

uint16_t readFingerSize(uint8_t num);

getFingerNum()

功能说明:

最后一次读取触摸手指数量

函数原型:

uint8_t getFingerNum(void);

isFingerUp()

功能说明:

检测手指是否抬起

函数原型:

bool isFingerUp(void);

flush()

功能说明:

将当前触摸状态清空

函数原型:

void flush(void);

readFinger()

功能说明:

读取触摸手指信息,返回结构体实例

函数原型:

tp_finger_t readFinger(uint8_t num);

结构体实例:

cpp
1 2 3 4 5 6 7
typedef struct
{
uint16_t x;
uint16_t y;
uint16_t id;
uint16_t size;
}tp_finger_t;

案例程序:

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 43
#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);
}
}
}
}
On This Page