Software

The robot's firmware is built using PlatformIO with the Arduino framework over ESP-IDF.

Prerequisites

To prepare the frontend code for the ESP32, a specific build chain is required. Start by installing these essential tools:

Required Software

Install the following software to ensure all functionality:

VSCode - Preferred IDE for development
Node.js - Needed for app building
A package manager of your choice (npm, pnpm, yarn)
Python 3.8 or higher - Used for firmware build scripts
ClangFormat - Used for formatting

Project Structure

Understand the project organization through these key directories:

docs/ - Documentation
app/ - SvelteKit-based frontend
esp32 - Firmware for the robot

Setting up PlatformIO

Configure Build Target

Modify the platformio.ini file at platformio.ini to match your board specifications. Adapt or remove environment settings as necessary based on your board.

[platformio]
...
default_envs = esp32dev
...

[env:esp32cam]
board = esp32cam
board_build.mcu = esp32c3

For additional boards, refer to the official board list.

Factory settings

Update the esp32/factory_setting.ini with new Wi-Fi settings, app name and other device information.

Build & Upload Process

Update the platformio.ini file for your board, then navigate to the PlatformIO tab, select your environment, click Upload Filesystem Image and after uploading finishes, click Upload and Monitor. The filesystem image only needs to be uploaded the first time. It will override config files on the microcontroller. When uploading new firmware, the app is evaluated, and if necessary, will be rebuilt.

2.1 KiB Raw Permalink Blame History