Back to Explorer

esp32-ILI9488

Project Information

Author

Mikrobot.pl

Board

ESP32 Dev Module

SDK Version

3.3.6

Platform

ESP32

Created

Updated

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 (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.

Sorry, your browser doesn't support Web Serial.Web Serial requires HTTPS.

README

ESP32 ILI9488 Matrix Captive Portal Display

Example usage

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_SPI driver)
  • Adafruit GFX Library (pulled in as a dependency)

ESP32 core built-ins (no extra install):

  • WiFi
  • WebServer
  • DNSServer

How to use

  1. Flash the firmware to ESP32 using FlashESP.
  2. Power up ESP32 + TFT.
  3. Connect your phone/PC to Wi-Fi network: ESP32_Display (open network).
  4. Captive portal should open automatically (if not, open any site or go to http://192.168.4.1).
  5. Enter a text and press Display.
  6. The text appears centered while Matrix background continues.

Default text on boot: mikrobot.pl