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

Pick a board to start.

Design the UI next

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

See how the editor works

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