Migrating from Sonoff Tasmota

Migrating from previous Sonoff Tasmota setups is very easy. You just need to have ESPHome create a binary for you and then upload that in the Tasmota web interface.

Getting the Binary

First create a configuration for your device. Then, generate and download the legacy binary:

  • Using the Home Assistant add-on/dashboard: Just click the COMPILE button, wait for the compilation to end and press the DOWNLOAD BINARY button.

    ../_images/download_binary.png

  • Using the command line: run esphome livingroom.yaml compile (replacing livingroom.yaml with your configuration file of course) and navigate to the <NODE_NAME>/.pioenvs/<NODE_NAME>/ folder. There you will find a firmware.bin file. This is the binary that you will upload.

Uploading the Binary

To upload the binary, navigate to the Tasmota web interface and enter the “Firmware Upgrade” section.

../_images/tasmota_main.png

In the “Upgrade by file upload” section, choose the binary you previously downloaded

../_images/tasmota_ota.png

If everything succeeds, you will see an “Upload Successful” message and ESPHome will connect to the WiFi network configured in your .yaml file. 🎉

../_images/tasmota_upload.png

Happy Hacking!

Note

When using the esp8266_pwm output platform and switching from Tasmota, you need to power-cycle the device once. After that the dimming functionality will work as usual and no more power cycles are required.

Note

If you are using Tasmota 8+ and get an error after uploading the firmware, go to the console and type `SetOption78 1`, then restart the device and try the firmware again.

See Also