mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-10-29 08:09:47 +01:00
52 lines
1.7 KiB
ReStructuredText
52 lines
1.7 KiB
ReStructuredText
Relay
|
|
=====
|
|
|
|
.. seo::
|
|
:description: Instructions for using relays in ESPHome.
|
|
: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 ESPHome, 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`
|