注意

这是最新开发分支配套的文档，可能包含已发布版本中尚未提供的功能。如果您要查看特定版本的文档，请使用左侧的下拉菜单并选择所需要的版本。

TOUCH 模块 API 手册

概述

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

API 介绍

TOUCH 类位于 machine 模块下。

示例

from machine import TOUCH

# 实例化 TOUCH 设备 0（系统默认触摸）
tp = TOUCH(0)
# 获取 TOUCH 数据（返回元组，每个元素为 TOUCH_INFO 对象）
p = tp.read()
print(p)
# 打印触摸点坐标
# print(p[0].x)
# print(p[0].y)
# print(p[0].event)

构造函数

# 系统默认触摸
touch = TOUCH(dev)

# 自定义触摸设备（dev != 0，需指定i2c，分辨率等）
touch = TOUCH(dev, i2c=my_i2c, range_x=800, range_y=480, rotate=TOUCH.ROTATE_0)

参数

• dev: 触摸设备号，0为系统默认，非0为自定义设备。

• rotate: 坐标旋转，见常量，默认-1（使用设备默认）。

• range_x, range_y: 仅自定义设备有效，指定触摸屏分辨率。

• i2c: 仅自定义设备有效，I2C总线对象，必填。

• rst, int: 仅自定义设备有效，复位/中断引脚对象，选填。

• 其余参数（如 type, slave_addr）已废弃。

read 方法

TOUCH.read([count])

获取触摸数据。

参数

• count: 最多读取的触摸点数量，范围[1, 最大支持数]，默认1。

返回值

返回触摸点数据，类型为元组 (<TOUCH_INFO 对象>, ...)，每个元素为 TOUCH_INFO 实例。

deinit 方法

TOUCH.deinit()

释放 TOUCH 资源。

参数

无

返回值

无

TOUCH_INFO 类

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

• event: 事件码，见常量

• track_id: 触点 ID，用于多点触摸。

• width: 触点宽度。

• x: 触点的 x 坐标。

• y: 触点的 y 坐标。

• timestamp: 触点时间戳。

常量

触摸事件

• TOUCH.EVENT_NONE：无事件

• TOUCH.EVENT_UP：抬起

• TOUCH.EVENT_DOWN：按下

• TOUCH.EVENT_MOVE：移动

坐标旋转

• TOUCH.ROTATE_0：不旋转

• TOUCH.ROTATE_90：旋转90度

• TOUCH.ROTATE_180：旋转180度

• TOUCH.ROTATE_270：旋转270度

• TOUCH.ROTATE_SWAP_XY：XY互换

触摸类型（兼容保留，实际值均为0）

• TOUCH.TYPE_CST226SE

• TOUCH.TYPE_CST328

• TOUCH.TYPE_GT911