触摸屏示例

简介

本示例基于 RT-Smart 触摸 HAL 演示触摸设备读点流程，包含两种模式：

• 使用已存在触摸设备进行读点测试

• 通过配置参数动态创建设备后进行读点测试

示例源码：src/rtsmart/examples/peripheral/touch/test_touch.c

示例能力

• 读取并打印触摸点事件（DOWN/MOVE/UP）

• 支持多点触控数据读取（示例缓冲区上限 5 点）

• 打印设备能力信息（最大触点数、坐标范围等）

• 打印当前触摸配置与默认旋转信息

• 支持 Ctrl+C 安全退出，并自动释放资源

关键接口（对应实际代码）

• drv_touch_inst_create()：创建触摸实例

• drv_touch_read()：读取触摸点数据

• drv_touch_get_info()：查询设备信息

• drv_touch_get_config()：读取设备配置

• drv_touch_get_default_rotate()：读取默认旋转

• drv_touch_inst_destroy()：销毁实例

• canmv_misc_create_touch_device()：动态注册触摸设备

• canmv_misc_delete_touch_device()：删除动态注册设备

编译与运行

编译

在 SDK 根目录启用对应示例后编译，或独立编译：

cd src/rtsmart/examples/peripheral/touch
make

运行模式 1：测试已有设备

./test_touch -d 0

运行模式 2：动态创建设备后测试

./test_touch -c --index 1 --range-x 480 --range-y 800 --int-pin 23 --int-value 1 --reset-pin 22 --reset-value 0 --i2c-bus 3 --i2c-speed 400000

说明：示例退出时会自动尝试注销通过 -c 创建的触摸设备。

常用参数

参数	说明
-d, --device	使用已有触摸设备 ID（默认 0）
-c, --create	按后续参数动态创建触摸设备
--index	新设备索引
--range-x, --range-y	坐标范围
--int-pin, --int-value	中断引脚与有效电平
--reset-pin, --reset-value	复位引脚与有效电平
--i2c-bus, --i2c-speed	I2C 总线号与速率

输出解读

示例会打印：

• 设备基础信息：类型、厂商、最大触点数、坐标范围

• 当前配置：I2C、引脚、显示范围等

• 触点明细：event、track_id、x/y、width、timestamp

当无事件时，示例会周期性输出 .，表示循环正常但当前无触摸数据。

提示

触摸输入通常依赖 I2C + GPIO（中断/复位）。建议先确认引脚复用与电平配置，再进行触摸读点测试。完整接口和调用顺序请参考 Touch API 文档。