Tutorial building and uploading with platformio

• First make sure you’ve installed platformio. Follow this tutorial: Tutorial_Install_Platformio

Do you want to send your changes back to us, so they stay in ESPEasy and keep getting supported?

• Yes: You’ll need to setup github as first. Follow this tutorial: Tutorial_preparing_to_work_with_github
• No: Just download the latest release zip-file here: https://github.com/letscontrolit/ESPEasy/releases and you'll be fine.

Use the correct version

• If you use git: Make sure you’ve checked out the correct branch. Currently you should use the mega-branch:

Note: If you forgot to change your default branch and then switch to the mega-branch, the submodules will not be cloned. Easiest is to change the default branch on github and clone it again. (dont forget to remove the local files) See: Tutorial_preparing_to_work_with_github

• If you just download a release zip-file, make sure its v2.0.0-dev5 or later.

Opening ESPEasy in Atom

• If you’re using Github Desktop you can just click the Atom icon inside it:

• If you just downloaded and extracted the release zip-file, extract it somewhere. Start Atom manually and click File -> Open folder to open the Source thats inside the zip-file.

First time startup annoyances

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.