Tutorial building and uploading with platformio
First make sure you’ve installed platformio. Follow this tutorial:
If you want to contribute your changes back to use you’ll need to setup github as well. Follow this tutorial:
Otherwise just download the latest release zip-file here: https://github.com/letscontrolit/ESPEasy/releases
Use the correct version
If you use git: Make sure you’ve checked out the correct branch. Currently you should use the mega-branch.
Change it with Github Desktop. If you change the branch, the contents of the directory you’ve cloned to will change as well:
If you download a release zip-file, make sure its v2.0.0-dev…. or later.
Opening ESPEasy in Atom
If you’re using Github Desktop you can just click the Atom icon inside it:
Otherwise open atom manually and Open folder to open the ESPEasy folder.
The first time you need to close all the tabs and while you’re doing that pay attention to the checkboxes: Disable the welcome screen Disable the PlatforIO homescreen startup. Answer the telemetry question.
Its important that you at least open one .ino file from the left. (otherwise platformio doesnt know which project to build)
The first time atom will complain about the Smart Code Linter. The codelinter makes coding easier so you could to install it. Make sure you either install it correctly or disable it. I was impatient and enabled it without installing the rest and that made Atom hang all the time.
Now your atom editor should look like this:
No annoying tabs, just files on the left and one file open.
Building and uploading the source code
If you press F7 you will get an overview of possible versions you can build:
The list is a bit long but there is logic to it.
You can choose 3 types of plugin sets: env:normal Build only the normal stable plugins. env:tes: Also include the plugins that are still in the testing stadium. These may have some problems, if so, please report them. In the webinterface they will show up with [TESTING] Env:dev Also include plugins that are still in development. These are usually not finshed, or still contain bugs. They will show up with [DEVELOPMENT]
There are multiple firmware sizes: 1024: For esp8266 with 1Mbyte flash. 4096: For esp8266 with 4Mbyte flash.
Choose with one you want to build and/or upload.
Now you can fix or enhance ESPEasy yourself.
If you want to contribute back your changes look at this tutorial:�
� Lets say you’ve found an error you want to fix and then contribute back to us.
