esp32-ILI9488
Project Information
ESP32 creates an open Wi-Fi Access Point (no password) with a captive portal. From the portal you can set a text that is displayed centered on a 3.5" ILI9488 TFT (320×480). In the background a Matrix-style falling characters animation runs continuously with more visible black space and random column activity.
Flash to Device
Login required: You need to login or create an account to flash this project.
Source Files (3)
Download AllREADME
ESP32 ILI9488 Matrix Captive Portal Display
Short description
ESP32 creates an open Wi-Fi Access Point (no password) with a captive portal.
From the portal you can set a text that is displayed centered on a 3.5" ILI9488 TFT (480×320).
In the background a Matrix-style falling characters animation runs continuously with more visible black space and random column activity.
Wiring (ESP32 ↔ ILI9488 SPI 3.5" 480×320)
This setup uses ESP32 VSPI hardware pins (recommended).
| ILI9488 / TFT pin | ESP32 pin | Notes |
|---|---|---|
| VCC | 3.3V | TFT logic power |
| GND | GND | Ground |
| CS | GPIO 5 | Chip Select |
| DC / RS | GPIO 2 | Data/Command |
| RESET / RST | GPIO 4 | Reset (can be tied to ESP32 EN, but GPIO recommended) |
| SCK / CLK | GPIO 18 | SPI clock (VSPI SCK) |
| MOSI / SDA | GPIO 23 | SPI MOSI (VSPI MOSI) |
| MISO / SDO | GPIO 19 | SPI MISO (VSPI MISO) |
| LED / BL | VIN (5V) | Backlight power (as requested) |
Notes
- Ensure your TFT module supports 3.3V logic on SPI lines (most ILI9488 SPI modules do; some 3.5" boards expect 5V logic and need level shifting).
- ILI9488 over SPI uses 18-bit color (RGB666, 3 bytes per pixel) and tops out around 24 MHz SPI. If you see artifacts, lower the clock with
tft.begin(16000000). - LED/BL to VIN (5V) is common, but if your module has no current limiting, consider powering BL from 3.3V or through a resistor/transistor. The library can also drive it from a GPIO via
tft.initBacklight(pin)/tft.setBacklight(0-255). - If you also use microSD on the same module, it shares SPI lines; you'll need a separate SD_CS pin (not used in this project).
Required libraries
Install these via Arduino Library Manager:
- DIYables TFT SPI (provides the
DIYables_ILI9488_SPIdriver) - Adafruit GFX Library (pulled in as a dependency)
ESP32 core built-ins (no extra install):
- WiFi
- WebServer
- DNSServer
How to use
- Flash the firmware to ESP32 using FlashESP.
- Power up ESP32 + TFT.
- Connect your phone/PC to Wi-Fi network: ESP32_Display (open network).
- Captive portal should open automatically (if not, open any site or go to
http://192.168.4.1). - Enter a text and press Display.
- The text appears centered while Matrix background continues.
Default text on boot: mikrobot.pl