Example of SDL3 for ESP32

Fork of SDL3 to ESP32 ESP-IDF v5.3+

On-line Demo Simulation

Run the ESP32-P4 simulation with Wokwi.com

Working parts:

• minimalistic SDL3 build
• SDL3 - littlefs integration
• SDL3_timer
• SDL3_events
• SDL_image - BMP
• SDL_ttf
• Lua 5.5
• touch

Requirements

idf_component_manager 2.x - install manually

Build

git clone git@github.com:georgik/esp32-sdl3-test.git
cd esp32-sdl3-test

idf.py @boards/esp-box-3.cfg build

Other boards

• ESP32-S3-BOX-3

idf.py @boards/esp-box-3.cfg build

• ESP32-S3-BOX (prior Dec. 2023)

idf.py @boards/esp-box.cfg build

• ESP32-P4

idf.py @boards/esp32_p4_function_ev_board.cfg build

• M5Stack-CoreS3

idf.py @boards/m5stack_core_s3.cfg build

Build for ESP32-C6-DevKit or other custom DevKit

The configuration of this board is based on ESP-BSP Generic which allows configuration using menuconfig.

SPI Display configuration:

CONFIG_BSP_DISPLAY_ENABLED=y
CONFIG_BSP_DISPLAY_SCLK_GPIO=6
CONFIG_BSP_DISPLAY_MOSI_GPIO=7
CONFIG_BSP_DISPLAY_MISO_GPIO=-1
CONFIG_BSP_DISPLAY_CS_GPIO=20
CONFIG_BSP_DISPLAY_DC_GPIO=21
CONFIG_BSP_DISPLAY_RST_GPIO=3
CONFIG_BSP_DISPLAY_DRIVER_ILI9341=y

You can change the configuration by running:

idf.py @boards/esp32_c6_devkit.cfg menuconfig

Build, flash and monitor the application:

idf.py @boards/esp32_c6_devkit.cfg flash monitor

Run simulation in VS Code

• Build the project, to get binaries for simulation.
• Install Wokwi for VS Code.
• Open file boards/esp32_.../diagram.json.
• Click Play button to start simulation.
• Click Pause button to freeze simulation and display states of GPIOs.

Notes

• screen resolution bigger than 320x100 requires enabled PSRAM
• SDL surface for ESP-IDF framebuffer is defined for RGB565
• drawing surface requires SDL_FRect as destination, not SDL_Rect, in SDL_Rect case nothing draws

Credits

• FreeSans.ttf - https://github.com/opensourcedesign/fonts/blob/master/gnu-freefont_freesans/FreeSans.ttf