Arduino IDE settings for ESP32 display boards

A wrong PSRAM mode or partition scheme rarely gives a clear error. The sketch compiles, uploads, and then the screen stays black or the board reboots in a loop. Pick your board and you get the Tools menu settings its display driver was compiled with.

Tested settings for the 61 boards that have a display driver in the export. For 94 more boards we show the manufacturer's settings (or, for a few, settings several independent descriptions agree on), marked as not tested by us.

Pick a board to see its Arduino IDE settings.

Design the UI next

Build LVGL screens and events in the browser without code, then export an Arduino project.

See how the editor works

Where these settings come from

They are the same settings the README of an LCD Ultra Pro™ Arduino export gives for the board, and the driver was compiled with them using arduino-cli. Compiling isn't the same as running on the real board, so check the board page for the driver status.

For boards without a driver in the export, we show the settings from the manufacturer's own documentation where it gives them, clearly marked and linked to the source. We haven't compiled those ourselves, so treat them as the manufacturer's word, not ours. Boards with neither get no settings here: a guess would be worse than nothing.

OPI or QSPI PSRAM?

On the ESP32-S3 this is the setting people get wrong most often. Modules with 8 MB of PSRAM (N16R8, N8R8) almost always use octal PSRAM, so they need "OPI PSRAM". Choose QSPI on one of those and PSRAM simply isn't found, which a large RGB display can't run without. Your module's datasheet is the final word.

More free tools