Skip to main content

​
1. Install Arduino IDE + ESP32 core

  1. Download Arduino IDE: https://www.arduino.cc/en/software/
  2. Install the ESP32 boards package (Espressif)
    • Arduino IDE: Preferences -> Additional boards manager URLs
    • Add: https://espressif.github.io/arduino-esp32/package_esp32_index.json
    • Tools -> Board -> Boards Manager -> install esp32 by Espressif Systems

​
2. Open the firmware as an Arduino sketch

Arduino IDE expects an .ino entrypoint.
  1. Create a new sketch folder (example: elato_firmware/)
  2. Copy firmware sources into that folder (from firmware-arduino/)
  3. Rename main.cpp to elato_firmware.ino (or create elato_firmware.ino and include/forward the setup/loop entrypoints)
  4. Keep the other *.cpp and *.h files in the same sketch directory

​
3. Board + serial settings (match PlatformIO)

In Arduino IDE:
  • In the Sidebar, head over to Boards Manager and select Arduino ESP32 Boards by Ardiuno version 2.0.18-arduino.5
  • Tools -> Board -> ESP32S3 Dev Module (or the closest match to esp32-s3-devkitc-1)
  • Tools -> Upload Speed -> keep at 115200
  • Tools -> Port -> select your ESP32
  • Tools -> PSRAM -> enable if your board has it
  • Tools -> Partition Scheme -> select a scheme that supports 16MB flash (suggested: “Default 4MB with spiffs”)
  • Tools -> Serial Monitor speed: 115200

​
4. Libraries (match lib_deps from platformio.ini)

​
Install from Library Manager

Install these packages and versions:
  • ArduinoJson (^7.1.0)
  • WebSockets (^2.4.1)
  • ESPAsyncWebServer by ESP32Async (^3.7.6)
  • ESPAsyncTCP by ESP32Async (^3.4.4)
  • ESP32_Button (^0.0.1)

​
Install from GitHub (ZIP)

These are pulled from GitHub in PlatformIO; in Arduino IDE you can install them via: Sketch -> Include Library -> Add .ZIP Library...
  • arduino-audio-tools (tag v1.0.1): https://github.com/pschatzmann/arduino-audio-tools
  • arduino-libopus (commit/tag a1.1.0): https://github.com/pschatzmann/arduino-libopus

​
5. Build + upload

  1. Sketch -> Verify/Compile
  2. Sketch -> Upload
If you get missing header/library errors, double-check the GitHub ZIP installs and restart Arduino IDE.
Need help? Join our Discord community and to any questions and share ideas.