build with gitpod

Caution

This section is only relevant if you want to upload a self-compiled firmware with your own changes.

If you haven´t any firmware changes to test, please use the standard web-installer with precompiled firmwares.

---

The easiest way to build the sketch is via gitpod. Just download the gitpod extension for your Browser from gitpod homepage:

https://www.gitpod.io/docs/configure/user-settings/browser-extension

After that, you will see a new button on this repository page:

Just click on it. Repository will autmatically download, libraries installed and after compilation you will find the firmware.bin under path .pio

Tip

if your Board isn´t supported by web-installer and you are not able to setup WiFi crendentials via web-installer, please adjust your credentials in platformio.ini file at build_flags:

Adjust:

;    -D WIFISSID=\"gast\"             ; use fixed WiFi credentials if Improv-WiFi-Library isn´t supported by your board
;    -D WIFIPASSWORD=\"12345678\"     ; use fixed WiFi credentials if Improv-WiFi-Library isn´t supported by your board

to:

   -D WIFISSID=\"MySSID\"             ; use fixed WiFi credentials if Improv-WiFi-Library isn´t supported by your board
   -D WIFIPASSWORD=\"MyPassword\"     ; use fixed WiFi credentials if Improv-WiFi-Library isn´t supported by your board

If you need a recompilation or you have been changed your WiFi Credentials, please type in the commands:

• platformio run to compile the firmwares
• platformio run --target buildfs to build the littlefs.bin

Just download the needed files, please select your used ESP Architecture:

• firmware.bin
• partitions.bin
• bootloader.bin
• littlefs.bin

Upload firmware to your ESP32

Tip

Instead of using the ESP32 flash tool, you can try to use the Adafruit WebFlasher Tool

Attention: up from version 3.2.0, filesystem image (littlefs.bin) has also to be flashed!

Download the ESP32 Flash download tools from Espressif official website and extract it.

https://www.espressif.com/en/support/download/other-tools

Start flash_download_tool.exe select your ESP32 model and workmode "develop" and configure it like that:

Change the COM Port with your right one. Just click on "start" and enjoy.

Maybe you want to upload it by hand:

esptool.py -p COM6 -b 921600 --before default_reset --after hard_reset --chip esp32 write_flash --flash_mode dio --flash_freq 80m --flash_size 4MB 0x8000 partitions.bin 0x1000 bootloader.bin 0x00010000 firmware.bin 0x00350000 littlefs.bin