GSL3670 触摸屏控制器

gsl3670 触摸屏平台允许使用基于 GSL3670 芯片的触摸屏控制器与 ESPHome。配置中需要设置 I²C 总线才能使此触摸屏正常工作。

此控制器用于 Seeed Studio reTerminal D1001。

该组件需要在初始化期间将二进制固件文件加载到控制器中。使用内置模型时，此固件会自动从 esphome-libs/gsl3670-firmware 版本下载并缓存到本地，因此无需手动提供。下载会对照已知的 SHA-256 校验和进行验证。或者，也可以从自定义 URL 或本地文件提供固件文件。

基础触摸屏配置

# Example configuration entry using the built-in Seeed reTerminal D1001 model
touchscreen:
  platform: gsl3670
  id: my_touchscreen
  model: SEEED-RETERMINAL-D1001

# Example configuration entry for a custom touchscreen, firmware from a URL
touchscreen:
  platform: gsl3670
  id: my_touchscreen
  interrupt_pin: GPIOXX
  reset_pin: GPIOXX
  firmware:
    url: https://example.com/my_gsl3670_firmware.bin
    sha256: 2e50501ad83656fb6fa3d92591f9f31add4d442c8e8a79f29f5c4d335bd127a4

# Example configuration entry using a local firmware file
touchscreen:
  platform: gsl3670
  id: my_touchscreen
  interrupt_pin: GPIOXX
  reset_pin: GPIOXX
  firmware:
    file: my_gsl3670_firmware.bin

配置变量

id (可选, ID): 手动设置此触摸屏的 ID。
model (可选, string): 设置引脚分配、校准和固件默认值的预定义模型。目前支持：
- SEEED-RETERMINAL-D1001: Seeed Studio reTerminal D1001。为中断引脚、复位引脚、校准、轴向镜像/交换以及固件下载 URL 和校验和设置适当的默认值。
- CUSTOM: 不应用默认值；必须手动配置所有选项。这是默认值。
interrupt_pin (可选, Pin Schema): 触摸检测引脚。
reset_pin (可选, Pin Schema): 芯片复位引脚。
firmware (必填, dict): GSL3670 二进制固件文件的来源。使用内置模型时，此值会自动设置。必须提供 url 或 file 中的一个：
- url (可选, string): 固件文件的 URL。文件在构建时下载并缓存到本地。
- sha256 (可选, string): 下载的固件文件的预期 SHA-256 校验和。设置时，如果校验和不匹配，下载将被拒绝。
- file (可选, string): 本地固件文件的路径，用于代替从 url 下载。如果未在给定路径找到文件，组件还会在其自身目录中查找。

固件在配置验证时验证正确的格式和完整性。

还包括 Touchscreen 的所有其他选项。

Seeed reTerminal D1001 示例配置

i2c:
  - id: lcd_i2c
    sda:
      ignore_strapping_warning: true
      number: GPIO37
    scl:
      ignore_strapping_warning: true
      number: GPIO38
    scan: true
    frequency: 400kHz

touchscreen:
  - platform: gsl3670
    i2c_id: lcd_i2c
    model: SEEED-RETERMINAL-D1001

GSL3670 触摸屏控制器

基础触摸屏配置

配置变量

Seeed reTerminal D1001 示例配置

另请参阅