esphome-docs/guides/migrate_espurna.rst
2021-05-20 07:36:42 -07:00

64 lines
1.9 KiB
ReStructuredText

Migrating from ESPurna
======================
.. seo::
:description: Migration guide for installing ESPHome on ESPs running ESPurna.
:image: espurna.png
Migrating from previous ESPurna setups is very easy. You just need to have
ESPHome create a binary for you and then upload that in the ESPurna web interface.
Getting Binary
--------------
First follow the guides for the :ref:`different supported devices <devices>` and create a configuration
file. Then, generate and download the 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.
.. figure:: 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 you will upload.
Uploading Binary
----------------
To upload the binary, navigate to the ESPurna web interface and enter the
"General " section.
.. figure:: images/espurna_ota.png
:align: center
:width: 80.0%
In the "Upgrade" section, choose the binary you previously downloaded and press "Upgrade".
If everything succeeds, you should now have ESPHome on your node 🎉
.. note::
with ESPHome, you in most cases won't need to worry about the available flash size, as
the binary only ever includes the code that you are actually using.
.. figure:: images/espurna_upload.png
:align: center
:width: 90.0%
Happy Hacking!
See Also
--------
- :doc:`/devices/nodemcu_esp8266`
- :doc:`/devices/nodemcu_esp32`
- :doc:`/devices/esp8266`
- :doc:`/devices/esp32`
- :doc:`/devices/sonoff_s20`
- :doc:`/devices/sonoff_4ch`
- :doc:`migrate_espeasy`
- :doc:`migrate_sonoff_tasmota`
- :ghedit:`Edit`