跳转到内容

CAP1188 电容式触摸传感器

cap1188 传感器平台允许你在 ESPHome 中使用你的 CAP1188 (数据手册, Adafruit) 电容式触摸传感器。此传感器要正常工作,需要在配置中 设置 I²C 总线。

CAP1188 电容式触摸传感器。图片由 Adafruit 提供。
# 示例配置条目
cap1188:
id: cap1188_component
address: 0x29
reset_pin: GPIOXX
touch_threshold: 0x40
allow_multiple_touches: true
binary_sensor:
- platform: cap1188
id: touch_key0
channel: 0
name: "Touch Key 0"

配置由两部分组成:中心组件和每个通道单独的二进制传感器。

  • address(可选,int):传感器的 I²C 地址。默认为 0x29。

  • id(可选,ID):设置此传感器的 ID。

  • reset_pin(可选,Pin):设置启动时用于重置 CAP1188 板的引脚。

  • touch_threshold(可选,int):所有通道的触摸阈值。它定义了触摸检测的灵敏度。

    • 0x01 : 最高灵敏度——对触摸最敏感
    • 0x20 : 默认灵敏度
    • 0x40 : 中等灵敏度(透过 3mm 厚的塑料使用时的灵敏度)
    • 0x80 : 最低灵敏度——对触摸最不敏感
  • allow_multiple_touches(可选,boolean):是否允许多点触摸。默认为关闭。

cap1188 二进制传感器允许你在 ESPHome 中使用你的 CAP1188。 首先设置 组件/中心,然后使用此二进制传感器平台为每个触摸传感器创建单独的 二进制传感器。

配置变量:

  • cap1188_id(可选,ID):上面定义的 CAP1188 的 ID。适用于 I²C 总线上有多个 CAP1188 的情况。
  • channel(必选,int):触摸按键连接的 CAP1188 通道编号。
  • 来自 Binary Sensor 的所有其他选项。

NOTE

当前不支持 SPI。此时必须使用 I²C。