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 [email protected]: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

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