esphome-docs/components/binary_sensor/status.rst

36 lines
936 B
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Status Binary Sensor
====================
.. seo::
:description: Instructions for setting up MQTT status binary sensors.
:image: server-network.svg
The Status Binary Sensor exposes the node state (if its connected to via MQTT/native API)
for Home Assistant.
.. figure:: images/status-ui.png
:align: center
:width: 80.0%
.. code-block:: yaml
# Example configuration entry
binary_sensor:
- platform: status
name: "Living Room Status"
Configuration variables:
------------------------
- **name** (**Required**, string): The name of the binary sensor.
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
- All other options from :ref:`Binary Sensor <config-binary_sensor>`. (Inverted mode is not supported)
See Also
--------
- :doc:`/components/binary_sensor/index`
- :doc:`/components/mqtt`
- :apiref:`status/status_binary_sensor.h`
- :ghedit:`Edit`