esphome-docs/cookbook/relay.rst
Otto Winter 8d9b0d2375
Netlify (#153)
* Netlify

* Fix

* Faster doxygen

* Update Makefile

* Try without api

* Debug

* Fix

* Update Makefile

* Debug

* Try 1.8.13

* Remove debug

* Update Makefile

* Optimize
2019-02-07 13:54:45 +01:00

54 lines
1.8 KiB
ReStructuredText

Relay
=====
.. seo::
:description: Instructions for using relays in esphomelib.
:image: relay.jpg
:keywords: Relay
.. figure:: images/relay-full.jpg
:align: center
:width: 80.0%
Relays are simple electronics components that allow you to switch a high load
using only a single pin on your board.
On the inside of a relay there is a coil that's connected to the input signal.
Every time the input signal switches on, the current flowing through the coil induces
a magnetic field that closes a contact.
On the output side you have three pins: common (``COM``), normally open (``NO``) and
normally closed (``NC``). Connect ``COM`` and one of ``NO`` and ``NC`` in series
with your load. When the input turns on, ``NO`` is connected to ``COM`` and
when the input turns off, ``NC`` is connected to ``COM``.
.. warning::
Relays are a very common component in electronics, so there are *many* types of them and
I won't attempt to describe all of them (partly due to my own lack of knowledge). Please
check with the datasheet of your relay to see its current limits, what voltage it requires
and so on. Please also note that relays are physical components - as such, they have a limited
number of switches that can happen before they break.
To use a relay with esphomelib, use a :doc:`GPIO Switch </components/switch/gpio>`.
.. code-block:: yaml
switch:
- platform: gpio
name: "Relay"
pin: <PIN_RELAY_IS_CONNECTED_TO>
For a more complete example, check :doc:`Simple Garage Door </cookbook/garage-door>`.
See Also
--------
- :doc:`/components/switch/gpio`
- :doc:`/components/output/gpio`
- :doc:`/cookbook/garage-door`
- `How do relays work <https://www.explainthatstuff.com/howrelayswork.html>`__.
- :ghedit:`Edit`
.. disqus::