mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-12-24 17:08:15 +01:00
Docs for CAP1188 Capacitive Touch Sensor (#1589)
This commit is contained in:
parent
189a1afce6
commit
a16d4f3743
85
components/binary_sensor/cap1188.rst
Normal file
85
components/binary_sensor/cap1188.rst
Normal file
@ -0,0 +1,85 @@
|
|||||||
|
CAP1188 Capacitive Touch Sensor
|
||||||
|
===============================
|
||||||
|
|
||||||
|
.. seo::
|
||||||
|
:description: Instructions for setting up CAP1188 Capacitive Touch Sensor
|
||||||
|
:image: cap1188.jpg
|
||||||
|
:keywords: CAP1188
|
||||||
|
|
||||||
|
.. _cap1188-component:
|
||||||
|
|
||||||
|
Component/Hub
|
||||||
|
-------------
|
||||||
|
|
||||||
|
The ``cap1188`` sensor platform allows you to use your CAP1188
|
||||||
|
(`datasheet <https://cdn-shop.adafruit.com/datasheets/CAP1188.pdf>`__,
|
||||||
|
`Adafruit`_) Capacitive Touch Sensor with ESPHome. The :ref:`I²C <i2c>` bus is
|
||||||
|
required to be set up in your configuration for this sensor to work.
|
||||||
|
|
||||||
|
.. figure:: images/cap1188-full.jpg
|
||||||
|
:align: center
|
||||||
|
:width: 75%
|
||||||
|
|
||||||
|
CAP1188 Capacitive Touch Sensor. Image by `Adafruit`_.
|
||||||
|
|
||||||
|
.. _Adafruit: https://learn.adafruit.com/adafruit-cap1188-breakout/overview
|
||||||
|
|
||||||
|
.. code-block:: yaml
|
||||||
|
|
||||||
|
# Example configuration entry
|
||||||
|
cap1188:
|
||||||
|
id: cap1188_component
|
||||||
|
address: 0x29
|
||||||
|
reset_pin: 14
|
||||||
|
touch_threshold: 0x40
|
||||||
|
allow_multiple_touches: 0x80
|
||||||
|
|
||||||
|
binary_sensor:
|
||||||
|
- platform: cap1188
|
||||||
|
id: touch_key0
|
||||||
|
channel: 0
|
||||||
|
name: "Touch Key 0"
|
||||||
|
|
||||||
|
Configuration variables:
|
||||||
|
------------------------
|
||||||
|
|
||||||
|
The configuration is made up of two parts: The central component, and individual Binary sensors per channel.
|
||||||
|
|
||||||
|
- **address** (*Optional*, integer): The I²C address of the sensor. Defaults to ``0x29``.
|
||||||
|
- **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor.
|
||||||
|
- **reset_pin** (*Optional*, :ref:`config-pin`): Set the pin that is used to reset the CAP1188 board on boot.
|
||||||
|
- **touch_threshold** (*Optional*, integer): The touch threshold for all channels. This defines the sensitivity for touch detection.
|
||||||
|
- ``0x00``: Maximum sensitivity - Most sensitive to touch
|
||||||
|
- ``0x20``: Default sensitivity
|
||||||
|
- ``0x40``: Medium sensitivity (I used this sensitivity when being used through a 3mm sheet of plastic)
|
||||||
|
- ``0x80``: Minimum sensitivity - Least sensitive to touch
|
||||||
|
- **allow_multiple_touches** (*Optional*, boolean): Whether to allow multitouch. Defaults to off.
|
||||||
|
|
||||||
|
Binary Sensor
|
||||||
|
-------------
|
||||||
|
|
||||||
|
The ``cap1188`` binary sensor allows you to use your CAP1188 with ESPHome.
|
||||||
|
First, setup a :ref:`cap1188-component` and then use this binary sensor platform to create individual
|
||||||
|
binary sensors for each touch sensor.
|
||||||
|
|
||||||
|
|
||||||
|
Configuration variables:
|
||||||
|
|
||||||
|
|
||||||
|
- **name** (*Optional*, string): The name for the binary sensor.
|
||||||
|
- **cap1188_id** (*Optional*, :ref:`config-id`): The ID of the CAP1188 defined above. Useful for multiple CAP1188's on the I²C bus.
|
||||||
|
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
|
||||||
|
- **channel** (**Required**, integer): The channel number the CAP1188 the touchkey is connected to.
|
||||||
|
- All other options from :ref:`Binary Sensor <config-binary_sensor>`.
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
|
||||||
|
SPI is not currently supported. I²C must be used at this time.
|
||||||
|
|
||||||
|
See Also
|
||||||
|
--------
|
||||||
|
|
||||||
|
- :ref:`sensor-filters`
|
||||||
|
- :apiref:`cap1188/cap1188.h`
|
||||||
|
- `Adafruit CAP1188 Library <https://github.com/adafruit/Adafruit_CAP1188_Library>`__ by `Adafruit <https://www.adafruit.com/>`__
|
||||||
|
- :ghedit:`Edit`
|
BIN
components/binary_sensor/images/cap1188-full.jpg
Normal file
BIN
components/binary_sensor/images/cap1188-full.jpg
Normal file
Binary file not shown.
After Width: | Height: | Size: 168 KiB |
BIN
images/cap1188.jpg
Normal file
BIN
images/cap1188.jpg
Normal file
Binary file not shown.
After Width: | Height: | Size: 20 KiB |
@ -383,6 +383,7 @@ Binary Sensor Components
|
|||||||
Tuya Binary Sensor, components/binary_sensor/tuya, tuya.png
|
Tuya Binary Sensor, components/binary_sensor/tuya, tuya.png
|
||||||
Modbus Binary Sensor, components/binary_sensor/modbus_controller, modbus.png
|
Modbus Binary Sensor, components/binary_sensor/modbus_controller, modbus.png
|
||||||
XPT2046, components/binary_sensor/xpt2046, xpt2046.jpg
|
XPT2046, components/binary_sensor/xpt2046, xpt2046.jpg
|
||||||
|
CAP1188 Capacitive Touch Sensor, components/binary_sensor/cap1188, cap1188.jpg
|
||||||
Custom Binary Sensor, components/binary_sensor/custom, language-cpp.svg
|
Custom Binary Sensor, components/binary_sensor/custom, language-cpp.svg
|
||||||
|
|
||||||
Output Components
|
Output Components
|
||||||
|
Loading…
Reference in New Issue
Block a user