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 and get back here.
- No: Just download the latest release zip-file here: https://github.com/letscontrolit/ESPEasy/releases and continue this tutorial.
Contents
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 the correct version
- Press F7 and you will get an overview of possible versions you can build:
The list is a bit long but there is logic to it.
Plugin sets
You can choose 3 types of plugin sets:
- env:normal_... Build only the normal stable plugins.
- env:test_... 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]
Firmware size
Currently there are 2 firmware sizes:
- env:..._1024 For an esp8266 with 1Mbyte flash.
- env:..._4096: For an esp8266 with 4Mbyte flash.
For example, select: PlatformIO: Build (env:dev_4096))
When there are no errors continue with the next step.
Uploading and serial monitoring
- After building you can upload the firmware, also via the F7 menu:
When its done you have successfully build and flash your ESPEasy with platformio.
- To see what your ESP is doing go the Platformio menu and choose Serial monitor:
- When you reset your ESP you should see something like this:
Now you can fix issues or enhance ESPEasy yourself and upload and test the firmware!
If you want to contribute back your changes look at this tutorial: Tutorial_Contributing_Back_To_ESPEasy
