跳转到内容

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: "触摸键 0"

配置变量

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

address (可选, 整数): 传感器的 I²C 地址。默认为 0x29。
id (可选, ID): 设置此传感器的 ID。
reset_pin (可选, 引脚): 设置用于在启动时重置 CAP1188 板的引脚。
touch_threshold (可选, 整数): 所有通道的触摸阈值。这定义了触摸检测的灵敏度。
- 0x01: 最高灵敏度 - 对触摸最敏感
- 0x20: 默认灵敏度
- 0x40: 中等灵敏度（我在通过 3mm 塑料板使用时使用此灵敏度）
- 0x80: 最低灵敏度 - 对触摸最不敏感
allow_multiple_touches (可选, 布尔值): 是否允许多点触摸。默认关闭。

二进制传感器

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

配置变量：

cap1188_id (可选, ID): 上面定义的 CAP1188 的 ID。对于 I²C 总线上的多个 CAP1188 很有用。
channel (必需, 整数): 触摸键连接到的 CAP1188 通道号。
所有其他选项来自二进制传感器。

NOTE

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

另见