Pin planner for ESP32 display boards
On a display board the screen has already taken most of the GPIOs. What's left is often a short header, a few pins shared with the SD slot or the USB serial port, and a strapping pin or two. Pick your board and the parts from the parts wiki, and the planner hands out the free pins and tells you what it had to compromise on.
2. Parts you want to add
Design the UI next
Build LVGL screens and events in the browser without code, then export an Arduino project.
What it checks
Pins the manufacturer's pinout gives to the display, touch or SD card. Flash and PSRAM pins inside the module, and the strapping pins that decide how the chip boots. For analog parts it only picks ADC1 pins, because ADC2 readings fail while Wi-Fi is on. All I2C parts share one bus, and the address check is the same one the I2C address checker uses.
The chip facts (strapping, flash, USB and UART0 pins, ADC channels) come from Espressif's datasheets for the ESP32, ESP32-S3, ESP32-C3, ESP32-C5, ESP32-C6 and ESP32-P4. The P4 has no radio of its own, so on P4 boards both ADC units are fine for analog parts.
Before you solder
The free pin list comes from each board's documentation, and some notes say a pin still needs checking. Read the board note next to each pin. You can change any pin in the list, and the warnings update straight away.
More free tools
- Board finderNarrow the ESP32 display boards down by size, resolution, touch, PSRAM, shape, display interface, CAN / RS485, battery and free GPIOs.
- Arduino IDE settingsThe board type, PSRAM mode, flash size and partition scheme to pick in the Tools menu, plus the library versions the driver was compiled with.
- 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.