mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-23 18:46:50 +00:00
56 lines
3.4 KiB
Markdown
56 lines
3.4 KiB
Markdown
---
|
|
title: Tasmota
|
|
description: Instructions on how to integrate Tasmota with Home Assistant.
|
|
ha_category:
|
|
- Binary sensor
|
|
- Cover
|
|
- Fan
|
|
- Light
|
|
- Sensor
|
|
- Switch
|
|
ha_release: '0.117'
|
|
ha_iot_class: Local Push
|
|
ha_config_flow: true
|
|
ha_codeowners:
|
|
- '@emontnemery'
|
|
ha_domain: tasmota
|
|
ha_platforms:
|
|
- binary_sensor
|
|
- cover
|
|
- fan
|
|
- light
|
|
- sensor
|
|
- switch
|
|
ha_integration_type: integration
|
|
---
|
|
|
|
This integration allows you to control [Tasmota](https://tasmota.github.io/docs/) devices over MQTT.
|
|
|
|
## Requirements
|
|
|
|
- MQTT broker and the [MQTT integration](/integrations/mqtt/) set up in Home Assistant.
|
|
- Tasmota devices' MQTT setting configured to communicate with the MQTT broker.
|
|
- Tasmota devices flashed with version 9.2, or later (`tasmota-lite.bin` does not support this integration).
|
|
- Tasmota devices configured for native discovery (`SetOption19 0`). Go to the web interface of your Tasmota device, select **Tools** and then **Console**. Where you can see the placeholder **Enter command** type or paste `SetOption19 0` and hit **Return**.
|
|
- Although the Tasmota integration supports custom fulltopic it is strongly suggested to leave fulltopic at its default, Tasmota does not prevent setting an invalid or non-unique fulltopic, for example a fulltopic without the `%prefix%` or `%topic%` tokens.
|
|
|
|
## Supported features
|
|
|
|
Tasmota Buttons, Fans, Lights, Relays, Sensors, Shutters and Switches are supported.
|
|
|
|
- Tasmota Buttons will be added as Home Assistant `automation triggers` when `SetOption73` is enabled. No `binary_sensor` entity will be created. You can find the available `automation triggers` on the device screen. 
|
|
- Tasmota Lights will be added as Home Assistant `light` entities. Single channel Dimmers, RGB lights, RGB lights with Color Temperature control and RGB lights with White control are supported.
|
|
- Tasmota Relays will be added as Home Assistant `switch` entities, if `SetOption30 0`. If `SetOption30 1`, relays will be added as `light` entities.
|
|
- Tasmota Sensors will be added as Home Assistant `sensor` entities.
|
|
- Tasmota Shutters will be added as Home Assistant `cover` entities. Currently only Shutter modes 1 to 4 are supported. Shutter mode 5 and Tuya shutters are not supported.
|
|
- Tasmota Switches will be added as either Home Assistant `binary_sensor` entities or `automation triggers` depending on the `switchmode` used when `SetOption114` is enabled.
|
|
- The fan functionality in Tasmota devices with module configured as `iFan02` or `iFan03` will be added as Home Assistant `fan` entities. Tuya fans are not supported.
|
|
- The integration will also create up to eight Status Sensors, each one with a different information. Please note all the Status Sensors are disabled by default.
|
|
|
|
|
|
{% include integrations/config_flow.md %}
|
|
|
|
You must also configure each Tasmota device's MQTT settings to communicate with whatever MQTT broker you are using. Enter the broker address under host, and enter a username/password combination that allows access to the broker.
|
|
|
|
If using the Mosquitto Broker add-on for Home Assistant, first create a new Home Assistant user under {% my users title="Settings > People" %}. Then, in **Tasmota** > **Configure MQTT** under "Host" enter the address of your Home Assistant instance and under "User" and "Password" enter the Home Assistant user you just created.
|