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

# 示例配置条目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):是否允许多点触摸。默认为关闭。
二进制传感器
Section titled “二进制传感器”cap1188 二进制传感器允许你在 ESPHome 中使用你的 CAP1188。
首先设置 组件/中心,然后使用此二进制传感器平台为每个触摸传感器创建单独的
二进制传感器。
配置变量:
- cap1188_id(可选,ID):上面定义的 CAP1188 的 ID。适用于 I²C 总线上有多个 CAP1188 的情况。
- channel(必选,int):触摸按键连接的 CAP1188 通道编号。
- 来自 Binary Sensor 的所有其他选项。
NOTE
当前不支持 SPI。此时必须使用 I²C。