Merge branch 'next' of https://github.com/esphome/esphome-docs into next

components/binary_sensor/mpr121.rst

@@ -0,0 +1,60 @@
+MPR121 Capacitive Touch Sensor
+==============================
+
+.. seo::
+    :description: Instructions for setting up MPR121 Capacitive Touch Sensor
+    :image: mpr121.jpg
+    :keywords: MPR121
+
+The ``mpr121`` sensor platform allows you to use your MPR121
+(`datasheet <https://cdn-learn.adafruit.com/downloads/pdf/adafruit-mpr121-12-key-capacitive-touch-sensor-breakout-tutorial.pdf>`__,
+`Adafruit`_) Capacitive Touch Sensor with esphomelib. The :ref:`I²C <i2c>` is
+required to be set up in your configuration for this sensor to work.
+
+.. figure:: images/mpr121-full.jpg
+    :align: center
+    :width: 50.0%
+
+    MPR121 Capacitive Touch Sensor. Image by `Adafruit`_.
+
+.. _Adafruit: https://learn.adafruit.com/adafruit-mpr121-12-key-capacitive-touch-sensor-breakout-tutorial/overview
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    mpr121:
+      id: mpr121_component
+      address: 0x5A
+
+    binary_sensor:
+      - platform: mpr121
+        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.
+
+Base Configuration:
+
+- **address** (*Optional*, integer): The i2c address of the sensor. Defaults to ``0x5A``.
+- **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor.
+
+Binary Sensor Configuration:
+
+- **name** (**Optional**, string): The name for the binary sensor.
+- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
+- **channel** (*Required*, integer): The channel number at the mpr121 the touchkey is connected to.
+- All other options from :ref:`Binary Sensor <config-binary_sensor>`.
+
+See Also
+--------
+
+- :ref:`sensor-filters`
+- :apiref:`sensor/mpr121_sensor.h`
+- `Adafruit MPR121 Library <https://github.com/adafruit/Adafruit_MPR121_Library>`__ by `Adafruit <https://www.adafruit.com/>`__
+- :ghedit:`Edit`
+
+.. disqus::

index.rst

@@ -149,6 +149,7 @@ Binary Sensor Components
     Status, components/binary_sensor/status, server-network.svg
     ESP32 BLE Device, components/binary_sensor/esp32_ble_tracker, bluetooth.svg
     ESP32 Touch Pad, components/binary_sensor/esp32_touch, touch.svg
+    MPR121  Capacitive Touch Sensor, components/binary_sensor/mpr121, mpr121.jpg
     Nextion Touch, components/binary_sensor/nextion, nextion.jpg
     Template Binary Sensor, components/binary_sensor/template, description.svg
     Remote Receiver, components/binary_sensor/remote_receiver, remote.svg