XPT2046 触摸屏控制器(更新版本)
xpt2046 触摸屏平台允许在 ESPHome 中使用基于 XPT2046 芯片的电阻式触摸屏控制器(
数据手册,
AZ-Delivery)。许多廉价的 LCD 显示屏包含此控制器。
需要在配置中设置 SPI 才能使此传感器工作。
# 配置示例touchscreen: platform: xpt2046 id: my_touchscreen cs_pin: GPIOXX interrupt_pin: GPIOXX update_interval: 50ms threshold: 400 transform: mirror_x: true calibration: x_min: 280 x_max: 3860 y_min: 340 y_max: 3860配置由两部分组成:触摸屏组件和可选的单个二进制传感器。
基本配置:
-
id (可选, ID):设置此传感器的 ID。
-
cs_pin (可选, 引脚模式):片选引脚。 在开发板上通常标记为
T_CS。 -
interrupt_pin (可选, 引脚模式):触摸检测引脚。 在开发板上通常标记为
T_IRQ。如果未指定,组件将通过 SPI 使用轮询。 此键从 irq_pin 重命名而来。 -
update_interval (可选, 时间):检查传感器的间隔。 如果指定了
interrupt_pin,触摸将被近乎即时地检测到,此设置将仅用于释放检测。默认为50ms。 -
threshold (可选, int):检测触摸或释放的值。默认为
400。 -
calibration (**必填”):XPT2046 是电阻式触摸屏,需要逐设备进行校准。
-
x_min (**必填”, int):对应于触摸屏左边缘(如果指定了
swap_xy则为上边缘)的原始值。请参阅校准了解校准触摸屏的过程。 -
x_max (**必填”, int):对应于触摸屏右边缘(如果指定了
swap_xy则为下边缘)的原始值。 -
y_min (**必填”, int):对应于触摸屏上边缘(如果指定了
swap_xy则为左边缘)的原始值。 -
y_max (**必填”, int):对应于触摸屏下边缘(如果指定了
swap_xy则为右边缘)的原始值。
-
-
所有其他选项来自 基本触摸屏配置。