Software setup

Install Arduino IDE, add ESP32 board support, and install the required display libraries.

1. Install Arduino IDE

   Download Arduino IDE 2.x and install it.

   Arduino IDE 2.x is recommended. The legacy 1.x version may work but is not tested.
2. Add ESP32 board support

   1. Open Arduino IDE → File → Preferences
   2. In “Additional boards manager URLs” paste:
      https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
      
   3. Go to Tools → Board → Boards Manager, search esp32, install “esp32 by Espressif Systems”
3. Install libraries

   Go to Tools → Library Manager and install both:

   • Adafruit GFX Library
   • Adafruit ST7735 and ST7789 Library

   These correspond to the #include statements in the firmware:

   #include <Adafruit_GFX.h>
   #include <Adafruit_ST7789.h>
   
4. Configure board settings

   Go to Tools and set the following values:

   Setting	Value
   Board	ESP32C3 Dev Module
   USB CDC On Boot	Enabled
   CPU Frequency	160 MHz
   Upload Speed	921600

   USB CDC On Boot must be set to Enabled — otherwise the serial connection will not work and flashing may fail.