mirror of
https://github.com/m5stack/m5-docs.git
synced 2026-05-20 10:23:01 -07:00
104 lines
2.7 KiB
Markdown
104 lines
2.7 KiB
Markdown
# 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);`
|
||
|
||
```clike
|
||
typedef struct
|
||
{
|
||
uint16_t x;
|
||
uint16_t y;
|
||
uint16_t id;
|
||
uint16_t size;
|
||
}tp_finger_t;
|
||
|
||
```
|
||
|
||
**Example：**
|
||
|
||
```clike
|
||
#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);
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
```
|