Add MPR121 support (#176)

* solved issues image size, tabs to spaces, file location

* image name was incorrect

* image for index was missing

* remove duplicate image

* Update images

- Convert main index image from .png to .jpg
- Use full picture on component page
- Add adafruit attribution

* Remove MQTT ref

* fixed configuration rows
This commit is contained in:
Michiel van Turnhout 2019-02-27 13:35:49 +01:00 committed by Otto Winter
parent fd72aa779f
commit a58727bf7b
4 changed files with 61 additions and 0 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 203 KiB

View File

@ -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::

BIN
images/mpr121.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 21 KiB

View File

@ -146,6 +146,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