Tasmota

This integration allows you to control Tasmota devices over MQTT.

Requirements

• MQTT broker and the MQTT integration 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.

Configuration

To add the Tasmota integration to your Home Assistant instance, use this My button:

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 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.