2018-05-13 11:37:02 +02:00
|
|
|
GPIO Switch
|
|
|
|
|
===========
|
|
|
|
|
|
|
|
|
|
The ``gpio`` switch platform allows you to use any pin on your node as a
|
|
|
|
|
switch. You can for example hook up a relay to a GPIO pin and use it
|
|
|
|
|
through this platform.
|
|
|
|
|
|
2018-06-01 18:10:00 +02:00
|
|
|
.. figure:: images/gpio-ui.png
|
|
|
|
|
:align: center
|
|
|
|
|
:width: 80.0%
|
2018-05-13 11:37:02 +02:00
|
|
|
|
|
|
|
|
.. code:: yaml
|
|
|
|
|
|
|
|
|
|
# Example configuration entry
|
|
|
|
|
switch:
|
|
|
|
|
- platform: gpio
|
|
|
|
|
pin: 25
|
|
|
|
|
name: "Living Room Dehumidifier"
|
|
|
|
|
|
|
|
|
|
Configuration variables:
|
2018-08-24 22:44:01 +02:00
|
|
|
------------------------
|
2018-05-13 11:37:02 +02:00
|
|
|
|
2018-06-01 18:10:00 +02:00
|
|
|
- **pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The
|
|
|
|
|
GPIO pin to use for the switch.
|
|
|
|
|
- **name** (**Required**, string): The name for the switch.
|
2018-10-16 22:41:12 +02:00
|
|
|
- **power_on_value** (*Optional*, boolean): The state this switch should be initialized with on boot.
|
|
|
|
|
Please note that certain pins can have pull-up/down resistors that activate/deactivate a pin before
|
|
|
|
|
esphomelib can initialize them. Please check with a multimeter and use another pin if necessary.
|
2018-06-01 18:10:00 +02:00
|
|
|
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
|
|
|
|
|
- All other options from :ref:`Switch <config-switch>` and :ref:`MQTT Component <config-mqtt-component>`.
|
|
|
|
|
|
|
|
|
|
See Also
|
2018-08-24 22:44:01 +02:00
|
|
|
--------
|
2018-06-01 18:10:00 +02:00
|
|
|
|
|
|
|
|
- :doc:`index`
|
|
|
|
|
- :doc:`/esphomeyaml/components/output/gpio`
|
|
|
|
|
- :doc:`API Reference </api/switch/index>`
|
2018-06-04 08:17:22 +02:00
|
|
|
- `Edit this page on GitHub <https://github.com/OttoWinter/esphomedocs/blob/current/esphomeyaml/components/switch/gpio.rst>`__
|
2018-10-12 16:33:22 +02:00
|
|
|
|
|
|
|
|
.. disqus::
|
