跳转到内容

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

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

XPT2046 触摸屏控制器
# Example configuration entry
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 (可选, Pin Schema): 片选引脚。 通常在板上标记为 T_CS。

  • interrupt_pin (可选, Pin Schema): 触摸检测引脚。 通常在板上标记为 T_IRQ。如果未指定,组件将通过 SPI 进行轮询。此键已从 irq_pin 重命名。

  • update_interval (可选, Time): 检查 传感器的间隔。如果指定了 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)边缘的原始值。

  • 还包括 基础触摸屏配置 的所有其他选项。