From b55abf798dd85ea971ab69e1086b0c52e5810480 Mon Sep 17 00:00:00 2001 From: Erik Montnemery Date: Wed, 21 Oct 2020 01:21:06 +0200 Subject: [PATCH] Add tasmota documentation (#14956) Co-authored-by: Franck Nijhof --- source/_integrations/tasmota.markdown | 43 +++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 source/_integrations/tasmota.markdown diff --git a/source/_integrations/tasmota.markdown b/source/_integrations/tasmota.markdown new file mode 100644 index 00000000000..e0f4b43268b --- /dev/null +++ b/source/_integrations/tasmota.markdown @@ -0,0 +1,43 @@ +--- +title: Tasmota (beta) +description: Instructions on how to integrate Tasmota with Home Assistant. +ha_category: + - Binary Sensor + - Light + - Sensor + - Switch +ha_release: '0.117' +ha_iot_class: Local Push +ha_config_flow: true +ha_codeowners: + - '@emontnemery' +ha_domain: tasmota +--- + +This integration allows you to control Tasmota devices over MQTT. + +## Requirements + +- MQTT server and the [MQTT integration](/integrations/mqtt/) set up in Home Assistant. +- Tasmota devices flashed with 9.0.0.1 or later +- Tasmota devices configured for native discovery (`SetOption19 0`) + +## Limitations + +Lights, relays, sensors and switches are supported. + +- Lights will be added as Home Assistant `light` entities. +- Relays will be added as Home Assistant `switch` entities, if `SetOption30 = 1`. If `SetOption30 = 0`, relays will be added as `light` entities. +- Sensors will be added as Home Assistant `sensor` entities. +- Switches will be added as Home Assistant `binary_sensor` entities, if a `switchtopic` is set or there is no corresponding power device (light, relay, etc.). + +## Configuration + +This integration can be configured using the integrations in the +Home Assistant frontend. + +Menu: **Configuration** -> **Integrations**. + +Click on the `+` sign to add an integration and click on **Tasmota (beta)**. +After completing the configuration flow, the Tasmota integration will be +available.