esphome-docs/components/switch/shutdown.rst

38 lines
1.0 KiB
ReStructuredText
Raw Normal View History

2018-05-13 11:37:02 +02:00
Shutdown Switch
===============
2018-11-14 22:12:27 +01:00
.. seo::
:description: Instructions for setting up switches that can remotely shut down the ESP.
:image: power_settings.svg
2018-11-14 22:12:27 +01:00
2018-05-13 11:37:02 +02:00
The ``shutdown`` switch platform allows you to shutdown your node remotely
through Home Assistant. It does this by putting the node into deep sleep mode with no
wakeup source selected. After enabling, the only way to startup the ESP again is by
pressing the reset button or restarting the power supply.
2018-06-01 18:10:00 +02:00
.. figure:: images/shutdown-ui.png
:align: center
:width: 80.0%
2018-05-13 11:37:02 +02:00
.. code-block:: yaml
2018-05-13 11:37:02 +02:00
# Example configuration entry
switch:
- platform: shutdown
name: "Living Room Shutdown"
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
- **name** (**Required**, string): The name for the switch.
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
2019-02-17 12:28:17 +01:00
- All other options from :ref:`Switch <config-switch>`.
2018-06-01 18:10:00 +02:00
See Also
2018-08-24 22:44:01 +02:00
--------
2018-06-01 18:10:00 +02:00
- :doc:`restart`
- :doc:`template`
2019-05-12 22:44:59 +02:00
- :apiref:`shutdown/shutdown_switch.h`
- :ghedit:`Edit`