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.
Design the UI next
Build LVGL screens and events in the browser without code, then export an Arduino project.
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
- Board finderNarrow the ESP32 display boards down by size, resolution, touch, PSRAM, shape, display interface, CAN / RS485, battery and free GPIOs.
- Pin plannerPick a board and the sensors you want to add. It hands out the free GPIOs and warns about strapping pins, pins the display uses and I2C address clashes.
- Board comparisonTwo or three ESP32 display boards side by side: screen, controller, touch, PSRAM, free GPIOs and driver status, with the differences highlighted.
- LVGL memory calculatorEstimate how much RAM your LVGL screens, widgets and images need, and how that compares with the SRAM and PSRAM of the board.
- Boards by controller chipLook up a display or touch controller (ST7789, ST7701, GT911, CST816…) and see which boards use it.
- LVGL symbol browserEvery built-in LV_SYMBOL icon of LVGL 8.4 with a preview, its code point and UTF-8 bytes, ready to copy.
- I2C address checkerCheck if your I2C sensors can share one bus with the chips already on the board, and how to move an address.