跳转到内容

XPT2046 触摸屏控制器(更新版本)

xpt2046 触摸屏平台允许在 ESPHome 中使用基于 XPT2046 芯片的电阻式触摸屏控制器( 数据手册AZ-Delivery)。许多廉价的 LCD 显示屏包含此控制器。 需要在配置中设置 SPI 才能使此传感器工作。

XPT2046 触摸屏控制器
# 配置示例
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 则为右边缘)的原始值。

  • 所有其他选项来自 基本触摸屏配置