2.16 TOUCH 模块 API 手册#

1. 概述#

触摸模块基于 RTT 的触摸框架，支持单点和多点电容触摸屏及电阻触摸屏。

2. API 介绍#

TOUCH 类位于 machine 模块下。

示例

from machine import TOUCH

# 实例化 TOUCH 设备 0
tp = TOUCH(0)
# 获取 TOUCH 数据
p = tp.read()
print(p)
# 打印触摸点坐标
# print(p[0].x)
# print(p[0].y)
# print(p[0].event)

构造函数#

touch = TOUCH(index, rotation)

参数

index: TOUCH 设备号，取值范围为 [0, 9]，实际值取决于存在的触摸设备数量。
rotation: 面板输出坐标与屏幕坐标的旋转，取值范围为 [0-3]，具体定义参考坐标旋转。

`read` 方法#

TOUCH.read([count])

获取触摸数据。

参数

count: 最多读取的触摸点数量，取值范围为 [0:10]，默认为 0，表示读取所有触摸点。

返回值

返回触摸点数据，类型为元组 ([tp[, tp...]])，其中每个 tp 是一个 touch_info 类实例。

`deinit` 方法#

TOUCH.deinit()

释放 TOUCH 资源。

参数

无

返回值

无

3. TOUCH_INFO 类#

TOUCH_INFO 类用于存储触摸点的信息，用户可通过相关只读属性访问。

event: 事件码，具体参考触摸事件。
track_id: 触点 ID，用于多点触摸。
width: 触点宽度。
x: 触点的 x 坐标。
y: 触点的 y 坐标。
timestamp: 触点时间戳。

4. 常量#

4.1 触摸事件#

EVENT_NONE: 无事件。
EVENT_UP: 触摸按下后抬起。
EVENT_DOWN: 触摸按下开始。
EVENT_MOVE: 触摸按下后移动。

4.2 坐标旋转#

ROTATE_0: 坐标不旋转。
ROTATE_90: 坐标旋转 90 度。
ROTATE_180: 坐标旋转 180 度。
ROTATE_270: 坐标旋转 270 度。

2.16 TOUCH 模块 API 手册

目录