← Docs · v0.3 · v0.4

Wiring — ILI9488 3.2” TFT Display

v0.3 and v0.4: TFT Display

Replaces the OLED. CP2102 and ELM327 wiring stays the same for v0.4.

ILI9488 SPI → ESP32

TFT PinESP32 PinWire colour
VCC3.3VRed
GNDGNDBlack
SCKGPIO18Blue
MOSIGPIO23Green
DCGPIO2Orange
RESETGPIO4Pink
CSGPIO15Purple
graph LR
    subgraph ESP32
        E_3V3[3.3V]
        E_GND[GND]
        E_18[GPIO18]
        E_23[GPIO23]
        E_2[GPIO2]
        E_4[GPIO4]
        E_15[GPIO15]
    end

    subgraph ILI9488 TFT
        T_VCC[VCC]
        T_GND[GND]
        T_SCK[SCK]
        T_MOSI[MOSI]
        T_DC[DC]
        T_RST[RESET]
        T_CS[CS]
    end

    E_3V3 -->|Red| T_VCC
    E_GND -->|Black| T_GND
    E_18 -->|Blue| T_SCK
    E_23 -->|Green| T_MOSI
    E_2 -->|Orange| T_DC
    E_4 -->|Pink| T_RST
    E_15 -->|Purple| T_CS

Library configuration

Libraries required:

  • TFT_eSPI — configure User_Setup.h for ILI9488 and the SPI pins listed above

WARNING: ILI9488 runs on 3.3V logic — matches ESP32 directly. No level shifter needed. Do NOT connect VCC to 5V.

WARNING: When display arrives — check which driver chip it uses (ILI9488 or ST7789). Look on back of board. Library config differs slightly between the two.