esphome-docs/esphomeyaml/components/status_led.rst

50 lines
1.5 KiB
ReStructuredText

Status LED
==========
.. seo::
:description: Instructions for setting up status LEDs in esphomelib to monitor the status of an ESP.
:image: led-on.png
The ``status_led`` hooks into all esphomelib components and can indicate the status of
the device. Specifically, it will:
- Blink slowly (about every second) when a **warning** is active. Warnings are active when for
example reading a sensor value fails temporarily or the WiFi/MQTT connections are disrupted.
- Blink quickly (multiple times per second) when an **error** is active. Errors indicate that
esphomelib has found an error while setting up. In most cases, esphomelib will still try to
recover from the error and continue with all other operations.
- Stay off otherwise.
.. code-block:: yaml
# Example configuration entry
status_led:
pin: GPIO2
Configuration variables:
------------------------
- **pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The
GPIO pin to operate the status LED on.
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
.. note::
If your LED is in an active-LOW mode (when it's on if the output is enabled), use the
``inverted`` option of the :ref:`Pin Schema <config-pin_schema>`:
.. code-block:: yaml
status_led:
pin:
number: D0
inverted: True
See Also
--------
- :doc:`API Reference </api/misc/status_led>`
- `Edit this page on GitHub <https://github.com/OttoWinter/esphomedocs/blob/current/esphomeyaml/components/status_led.rst>`__
.. disqus::