esphome-docs/guides/migrate_espeasy.rst

59 lines
1.8 KiB
ReStructuredText
Raw Normal View History

2018-06-01 18:10:00 +02:00
Migrating from ESPEasy
======================
2018-11-14 22:12:27 +01:00
.. seo::
2019-02-16 23:25:23 +01:00
:description: Migration guide for installing ESPHome on ESPs running ESPEasy.
:image: espeasy.svg
2018-11-14 22:12:27 +01:00
2018-06-01 18:10:00 +02:00
Migrating from previous ESPEasy setups is very easy. You just need to have
2019-02-16 23:25:23 +01:00
ESPHome create a binary for you and then upload that in the ESPEasy web interface.
2018-06-01 18:10:00 +02:00
Getting Binary
2018-10-12 16:33:22 +02:00
--------------
2018-06-01 18:10:00 +02:00
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.
2018-06-01 18:10:00 +02:00
.. figure:: images/download_binary.png
2019-02-16 23:25:23 +01:00
- **Using the command line**: run ``esphome livingroom.yaml compile`` (replacing
2018-06-01 18:10:00 +02:00
``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
2018-10-12 16:33:22 +02:00
----------------
2018-06-01 18:10:00 +02:00
To upload the binary, navigate to the ESPEasy web interface and enter the
"Tools " section.
.. figure:: images/espeasy_ota.png
:align: center
:width: 60.0%
Press "Load" under Firmware, then select the binary you previously downloaded and upload
2019-02-16 23:25:23 +01:00
the binary. If everything succeeds, you should now have ESPHome on your node 🎉.
2018-06-01 18:10:00 +02:00
.. note::
2019-02-16 23:25:23 +01:00
with ESPHome, you in most cases won't need to worry about the available flash size, as
2018-06-01 18:10:00 +02:00
the binary only ever includes the code that you are actually using.
Happy Hacking!
See Also
2018-10-12 16:33:22 +02:00
--------
2018-06-01 18:10:00 +02:00
- :doc:`/devices/nodemcu_esp8266`
- :doc:`/devices/nodemcu_esp32`
- :doc:`/devices/esp8266`
- :doc:`/devices/esp32`
- :doc:`/devices/sonoff_s20`
- :doc:`/devices/sonoff_4ch`
2018-06-01 18:10:00 +02:00
- :doc:`migrate_espurna`
- :doc:`migrate_sonoff_tasmota`
- :ghedit:`Edit`