esp32-ILI9341
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 2.8" ILI9341 TFT (320×240). 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 ILI9341 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 2.8" ILI9341 TFT (320×240).
In the background a Matrix-style falling characters animation runs continuously with more visible black space and random column activity.
Wiring (ESP32 ↔ ILI9341 SPI 2.8" 320×240)
This setup uses ESP32 VSPI hardware pins (recommended).
| ILI9341 / TFT pin | ESP32 pin | Notes |
|---|---|---|
| VCC | 3.3V | TFT logic power |
| GND | GND | Ground |
| CS | GPIO 5 | Chip Select |
| DC | 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 ILI9341 SPI modules do).
- 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.
- 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:
- Adafruit GFX Library
- Adafruit ILI9341
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